home *** CD-ROM | disk | FTP | other *** search
/ Programming Languages Suite / ProgLangD.iso / TURBOPASCAL WIN / README < prev    next >
Text File  |  1992-06-07  |  17KB  |  416 lines
  1.  
  2.                Welcome to Turbo Pascal for Windows 1.5
  3.                ---------------------------------------
  4.  
  5. This README file contains important, last minute information
  6. about Turbo Pascal for Windows.
  7.  
  8. In addition to the release notes in this file, browse the
  9. following text files in the \TPW\DOC directory:
  10.  
  11.   MANUAL.TPW, MANUAL.RW, README.RW, and README.TDW
  12.  
  13. These contain corrections to the printed documentation and other
  14. useful information.
  15.  
  16. A complete list of all files is provided in the file FILELIST.DOC
  17. in the \TPW directory.
  18.  
  19.  
  20. TABLE OF CONTENTS
  21. -----------------
  22. 1.  How to Get Help
  23. 2.  Installation
  24. 3.  System Requirements
  25. 4.  Turbo Help
  26. 5.  Features
  27. 6.  Release Notes
  28. 7.  Windows 3.1 Redistributable license
  29.  
  30. 1. HOW TO GET HELP
  31. -------------------
  32. If you have any problems, please read this file, the *.DOC files
  33. in \TPW\DOC, and the Turbo Pascal manuals first. If you still
  34. have a question and need assistance, help is available from the
  35. following sources:
  36.  
  37. 1. Type GO BORLAND on the CompuServe bulletin board system. If
  38.    you are not a member of CompuServe, see the enclosed brochure.
  39.  
  40. 2. Check with your software dealer or user group.
  41.  
  42. 3. If you have an urgent problem and you have sent in the license
  43.    agreement that accompanied this package, you may call the
  44.    Borland Technical Support Department at (408) 461-9144. Please
  45.    have the following information ready before calling:
  46.  
  47.    a. Product name and serial number from the distribution disks.
  48.  
  49.    b. Computer brand, model, and the brands and model numbers of
  50.       any additional hardware.
  51.  
  52.    c. Operating system and version number. (The version number
  53.       can be determined by typing VER at the DOS prompt. The
  54.       Windows version number is displayed in the Program
  55.       Manager's About Box.)
  56.  
  57.    d. Contents of your AUTOEXEC.BAT, CONFIG.SYS, TPW.INI and
  58.       WIN.INI files.
  59.  
  60.  
  61.  
  62. 2. INSTALLATION
  63. ---------------
  64.  
  65. NOTE: Before running the INSTALL program, you should disable any
  66. Windows screen savers.  The install process will not complete
  67. properly if interrupted by a screen saver.
  68.  
  69. NOTE: The installation program needs at least 1MB of free memory
  70. to run.
  71.  
  72. Use the INSTALL program to install Turbo Pascal for Windows. The
  73. files on the distribution disks are all archived and INSTALL will
  74. de-archive them, place them into subdirectories and automatically
  75. create configuration files for both the command-line compiler and
  76. the Integrated Development Environment (IDE). All further
  77. references to directory paths in this README file assume you've
  78. used INSTALL's default directory structure.
  79.  
  80. To run the installation program from Drive A type
  81.  
  82.     WIN A:INSTALL
  83.  
  84. or, if Windows is active, select Program Manager's File|Run
  85. command and type
  86.  
  87.     A:INSTALL
  88.  
  89. Install will unpack the compressed archive files (*.PAK) into
  90. subdirectories on your hard disk. These files can also be
  91. unpacked manually using the UNPAK.EXE utility. Your system must
  92. have at least two megabytes of memory available to run Turbo
  93. Pascal for Windows. Neither the Install program nor Turbo Pascal
  94. for Windows will run in real mode.
  95.  
  96. Path Information
  97. ----------------
  98. If you want to use the command line utilities provided with TPW
  99. 1.5, you will need to add the \TPW\UTILS directory to your DOS
  100. path.  Other than these utilities, TPW does not require any of
  101. its components to be listed on the DOS path.
  102.  
  103. Installing over Turbo Pascal for Windows Version 1.0
  104. ----------------------------------------------------
  105. You can install Turbo Pascal for Windows Version 1.5 to the same
  106. directory as version 1.0.  You can delete the Whitewater Resource
  107. Toolkit (located in \TPW\UTILS) in favor of using Resource
  108. Workshop, if desired.  The files you can delete are:  WRT.DAT,
  109. WRT.EXE, WRT.FON, WRT.IMA, and WRT.HLP.  In addition, updated
  110. versions of some Resource Workshop demos are located in the
  111. Resource Workshop demo directory (\TPW\RWDEMOS).  You can delete
  112. any duplicates of these newer files (located in \TPW\OWLDEMOS)
  113. also.
  114.  
  115. Online Help under Windows 3.0
  116. -----------------------------
  117. In order to access online help for Turbo Pascal or Resource
  118. Workshop, you must have the help system from Windows 3.1.  If the
  119. Install program detects that you are running Windows 3.0, it will
  120. attempt to rename your current versions of WINHELP.EXE and
  121. WINHELP.HLP, and replace them with the newer Windows 3.1 versions
  122. of the same files.  If this process fails (the Install program
  123. will alert you if this happens), you will need to manually copy
  124. the WINHELP.EXE and WINHELP.HLP from the \TPW directory to your
  125. Windows directory.
  126.  
  127. Note: If you installed under Windows 3.1, these files were not
  128. copied to your hard disk, since you already have the correct
  129. versions in your \WINDOWS directory.
  130.  
  131.  
  132. 3. SYSTEM REQUIREMENTS
  133. ----------------------
  134. Turbo Pascal for Windows requires at least 2 MB of RAM and runs
  135. on EGA, VGA (and above) and Hercules monochrome video adapters
  136. under Windows 3.0 and 3.1.
  137.  
  138.  
  139. 4. TURBO HELP
  140. -------------
  141. The fastest way to get help on any Turbo Pascal or Windows API
  142. feature is to use the online help system. Pull down the Help menu
  143. by typing Alt-H or press F1 for more information. TDW has its own
  144. help system and help file as well.
  145.  
  146.  
  147. 5. FEATURES
  148. -----------
  149. New features in Turbo Pascal for Windows 1.5 include
  150.  
  151.   o Syntax Highlighting in the editor - Language elements (e.g.,
  152.     reserved words, identifiers) are highlighted with selectable
  153.     colors and fonts. Refer to the "Syntax Highlighting" help
  154.     topic for complete documentation on this feature.
  155.  
  156.   o SpeedBar - Click an icon to perform common IDE operations,
  157.     such as File|Open or Compile|Make. Refer to the "SpeedBar"
  158.     help topic (Help|Search) for complete documentation on this
  159.     feature.
  160.  
  161.   o Resource Workshop - Use Borland's award-winning tool to
  162.     create and modify your menu, dialog, and other Windows 3.0
  163.     and 3.1 resources.
  164.  
  165.   o Full Access to Windows 3.1 - All the TPUs, DLLs and utilities
  166.     you need to take full advantage of the new Windows 3.1
  167.     features including Object Linking and Embedding (OLE),
  168.     Multimedia, TrueType fonts, PenWindows, etc.  Note: you must
  169.     have Windows 3.1 to take advantage of these features.
  170.  
  171.   o New demo programs:
  172.  
  173.     COMMDLGS.PAS  - How to access new Common Dialogs DLL
  174.     DDEMLCLI.PAS  - Example of a DDE client application
  175.     DDEMLSVR.PAS  - Example of a DDE server
  176.     MCISOUND.PAS  - Using MCI sound capabilities
  177.                     (requires special hardware)
  178.     OLECLI.PAS    - OLE client application
  179.     OLESERVR.PAS  - OLE server application
  180.     OWLPEN.PAS    - PenWindows example
  181.                     (requires Pen or MS compatible mouse)
  182.     PAINT.PAS     - Complete paint program
  183.     SHELLDEM.PAS  - Win 3.1 Shell API demo
  184.     TTDEMO.PAS    - Shows how to access new TrueType fonts
  185.  
  186.     (These programs and their accompanying files are located in
  187.      the \TPW\OWLDEMOS directory.  PAINT.PAS is in
  188.      \TPW\OWLDEMOS\PAINT.)
  189.  
  190.   o Easy access to Borland Window Custom Controls (BWCC) by using
  191.     the BWCC unit provided. Place this unit in your "uses" clause
  192.     to convert all dialogs and windows from StdDlgs and StdWnds
  193.     to BWCC style. The BWCC unit replaces the WObjectB and
  194.     StdDlgsB units that came with previous versions of Resource
  195.     Workshop.
  196.  
  197. Other Turbo Pascal for Windows features include
  198.  
  199.   o Windows IDE - A Windows-hosted environment that is a full MDI
  200.     application. You can edit and compile files in the IDE and
  201.     then call TDW to debug your programs. (The IDE even has
  202.     optional Wordstar compatible keys. Select the alternate
  203.     command set on the Options|Preferences dialog.)
  204.  
  205.   o The compiler and RTL have many extensions for programming
  206.     under Windows (see below). Refer to the demo programs in the
  207.     \TPW\WINDEMOS directory.
  208.  
  209.   o ObjectWindows - An application framework and library that
  210.     provides an object-oriented layer to Windows programming. Use
  211.     ObjectWindows' object-oriented techniques to build powerful
  212.     Windows applications quickly. ObjectWindows (OWL) demo
  213.     programs are in the \TPW\OWLDEMOS directory. OWL itself is in
  214.     the \TPW\OWL directory.
  215.  
  216.   o TDW - A special version of the Turbo Debugger that debugs
  217.     Windows 3.0 and 3.1 applications. TDW runs in text mode and
  218.     can be launched from the IDE via the RUN|DEBUGGER menu.
  219.  
  220.       o uses display swapping to support single monitor debugging
  221.       o full support for Windows DLLs
  222.       o break on Windows messages
  223.  
  224.     See README.TDW in the \TPW\DOC directory for the latest
  225.     information about TDW.
  226.  
  227.   o Help system compiler - Use the help compiler to create
  228.     Windows' online help for your programs. The help compiler
  229.     (HC.BAT) is in the \TPW\UTILS directory. The help examples
  230.     are in the \TPW\DOCDEMOS\HELPEX directory.
  231.  
  232.   o Other compiler and runtime library features:
  233.  
  234.     o Windows Crt unit (WinCrt) for writing "standard" programs
  235.       that use Writeln and Readln (see \TPW\WELCOME.PAS).
  236.     o Dynamic Method Tables
  237.     o Full support for Windows-style null-terminated strings
  238.     o Link in Windows resource Files ($R directive)
  239.     o Full support for DLLs (Dynamic Link Libraries).
  240.  
  241. A full suite of DOS command-line utilities, including a DOS
  242. command-line compiler (TPCW.EXE) that produces Windows programs,
  243. MAKE.EXE, and a Windows resource compiler (RC.EXE) are also
  244. provided.
  245.  
  246.  
  247. 6. RELEASE NOTES
  248. ----------------
  249.  
  250. Configuration Files
  251. -------------------
  252.   o TPW 1.5 uses the TPW.CFG to store configuration data.  This
  253.     file is intended to be modified only through the Integrated
  254.     Development Environment's dialog boxes.  Editing this file in
  255.     any other way may result in loss of configuration data.
  256.  
  257.  
  258. Runtime Libraries
  259. -----------------
  260.   o This version of the Turbo Pascal compiler is fully backwards
  261.     compatible with version 1.0.  However, WOBJECTS.TPU has been
  262.     updated.  Any third party units which list WOBJECTS in their
  263.     "uses" clause will therefore report a "Unit version mismatch"
  264.     error when compiling.  If you do not have the source code to
  265.     these third party units, you can either: a) continue to use
  266.     the WOBJECTS.TPU from TPW 1.0, or b) contact the author for
  267.     an updated unit.  Units to which you do have source code can
  268.     be recompiled using the Compile|Build option.
  269.  
  270.  
  271. Integrated Development Environment
  272. ----------------------------------
  273.   o The editor's Block Overwrite option is set to ON by default.
  274.     This is a change from version 1.0.
  275.  
  276.   o The Tile command's shortcut key is now Shift-F4, and Cascade
  277.     is now Shift-F5.  This is a change from version 1.0.  These
  278.     commands have also exchanged positions on the Window menu.
  279.  
  280.  
  281. Paradox Engine Sample Program
  282. -----------------------------
  283.   o Turbo Pascal for Windows can access Paradox data tables using
  284.     the Paradox Engine 2.0 Dynamic Link Library (DLL). An example
  285.     program that shows how this is done is included in the files
  286.     \TPW\OWLDEMOS\PXDEMO.PAS and \TPW\OWLDEMOS\PXACCESS.PAS. Note
  287.     that you will need the PXENGWIN.DLL and the sample Paradox
  288.     data files that are included with the Paradox Engine 2.0 in
  289.     order to run PXDEMO. The Paradox Engine 2.0 is available
  290.     separately from Borland and includes support for DOS and
  291.     Windows programming using Turbo Pascal, Borland C and C++,
  292.     and other languages.
  293.  
  294.  
  295. Resource Compiler
  296. -----------------
  297.   o Turbo Pascal for Windows 1.5 produces EXE files that will run
  298.     under Windows 3.0 and later. Here's a sample command line
  299.     that uses the resource compiler to produce an EXE that runs
  300.     only under Windows 3.1
  301.  
  302.       rc -31 myprog.exe
  303.  
  304.  
  305. Help Compiler
  306. -------------
  307.  
  308.   o The Help Compiler for Windows 3.0 (HC.EXE) has been replaced
  309.     by HC.BAT.  This batch file can run either the Windows 3.0
  310.     Help Compiler (HC30.EXE) or the Windows 3.1 Help Compiler
  311.     (HC31.EXE).
  312.  
  313.     By default, HC.BAT executes HC30.EXE, to produce a help file
  314.     that works with the versions of WINHELP.EXE in either Windows
  315.     3.0 or Windows 3.1.  To take advantage of the new Help
  316.     features of Windows 3.1, use "-n" as the first parameter to
  317.     HC.BAT, which will then execute HC31.EXE.
  318.  
  319.     HC.BAT, HC30.EXE, HC31.EXE are located in the utilities
  320.     directory. To use these utilities, you'll need to have the
  321.     \TPW\UTILS directory listed on your DOS PATH.
  322.  
  323.   o There is a complete help example, HELPEX.PAS, in the
  324.     directory \TPW\DOCDEMOS\HELPEX. There is also a complete
  325.     ObjectWindows version of this example (OWLHELP.PAS). You can
  326.     use the HELPEX.MAK file to make both examples by typing
  327.  
  328.       make -fhelpex.mak
  329.  
  330.     Make sure the command-line compiler (TPCW.EXE), the help
  331.     compiler (HC.BAT), the resource compiler (RC.EXE) and
  332.     MAKE.EXE are all on your DOS path. If you did not use the
  333.     installation program's default directory structure, you'll
  334.     need to modify HELPEX.MAK accordingly.
  335.  
  336.  
  337. OEM vs. ANSI Character Sets
  338. ---------------------------
  339.   o DOS text files use the OEM character set; Windows text files
  340.     generally use the ANSI character set. The demo program,
  341.     FCONVERT.PAS (located in \TPW\OWLDEMOS) converts data back
  342.     and forth between these formats. The only text files that
  343.     will be affected are those containing international
  344.     characters (ASCII values above 128) like the umlaut, etc. Not
  345.     all OEM characters are present in the ANSI character set, and
  346.     vice versa. Therefore, converting between these character
  347.     sets may produce a mapping that is not reversible. Refer to
  348.     your Windows documentation for further information about ANSI
  349.     vs. OEM character sets.
  350.  
  351.  
  352. Out of Date Drivers
  353. -------------------
  354.   o If your TPW IDE dialog boxes are unreadable, first delete
  355.     TPW.DSK, TPW.CFG and TPW.INI files and then run the IDE
  356.     again.  If the problem persists, contact your video card
  357.     manufacturer for an update of your video drivers, or use the
  358.     VGA.DRV driver supplied with Windows by Microsoft.
  359.  
  360.   o If you experience difficulty in printing from the IDE, make
  361.     sure you have the newest Windows 3.1 printer drivers from
  362.     Microsoft or from your printer vendor.
  363.  
  364.  
  365. Using the Windows 3.1 Debugging Kernel
  366. --------------------------------------
  367.   o The Turbo Pascal for Windows version 1.5 IDE works under
  368.     either the retail or the debugging kernel of Windows 3.1.
  369.     However, you might experience problems with printing from the
  370.     IDE under the debugging kernel.
  371.  
  372.  
  373. Using Adobe Type Manager
  374. ------------------------
  375.   o Older versions of Adobe Type Manager can cause some fonts to
  376.     not appear in the Options|Preferences dialog box. Adobe Type
  377.     Manager version 2.0 or later corrects this problem. You can
  378.     contact Adobe about upgrades at 1-800-521-1976.
  379.  
  380.  
  381. Turbo Pascal for DOS
  382. --------------------
  383.   o A DOS version of Turbo Pascal that produces DOS programs is
  384.     also available. Contact your dealer or distributor, or call
  385.     Borland for upgrade information at 1-800-331-0877 (U.S.
  386.     customers only).
  387.  
  388.  
  389. 7. WINDOWS 3.1 REDISTRIBUTABLE LICENSE
  390. --------------------------------------
  391. NOTE CONCERNING USE OF MICROSOFT WINDOWS 3.1 REDISTRIBUTABLES FOR
  392. APPLICATIONS RUNNING ON MICROSOFT WINDOWS 3.0
  393.  
  394. This Borland language product contains everything you need to
  395. develop applications to run on the most recent version of
  396. Microsoft Windows, version 3.1.  In some cases, you may need to
  397. copy and include with your application one or more Microsoft
  398. "redistributable" files from a copy of version 3.1 so that your
  399. application will also run on version 3.0. Microsoft informs us
  400. that you may copy the redistributable files from Microsoft
  401. Windows 3.1 for this purpose.  If you do so, you must comply with
  402. the conditions stated in the Borland No-Nonsense License
  403. Statement included in this package as if the redistributable
  404. files you copy were a part of this Borland language product.
  405. Microsoft's redistributable files in Windows 3.1 are:
  406. WINHELP.EXE, WINHELP.HLP, COMMDLG.DLL, DDEML.DLL, TOOLHELP.DLL,
  407. VTD.386, OLECLI.DLL, OLESVR.DLL, VER.DLL, LZEXPAND.DLL,
  408. EXPAND.EXE, REGLOAD.EXE, STRESS.DLL, DIB.DRV, MARKMIDI.EXE,
  409. SHELL.DLL and PENWIN.DLL.
  410.  
  411. Note that some of these files are distributed with Turbo Pascal
  412. for Windows 1.5 while others are part of the Windows 3.1 retail
  413. product.
  414.  
  415. * * *
  416.